home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / pascal / tpa22.zip / TPACFG.DOC < prev    next >
Text File  |  1989-10-16  |  5KB  |  144 lines
  1.   TPACFG         TP&Asm Compiler Configuration Utility         Version 2.21
  2.                 Copyright (c) 1989  Richard W. Prescott
  3.  
  4.  
  5.                   Configuration program for use with
  6.          TP&Asm Integrated Compile-Time Assembler Version 2.2x
  7.  
  8.  
  9. 1. Overview
  10.  
  11. I had assumed when I designed TP&Asm that all copies of Turbo Pascal
  12. with a specific version number would be identical to mine.  It now
  13. appears that there are at least three different revisions of TURBO.EXE
  14. version 5.5.  If your copy of TP55 is different from the one which I
  15. used in developing TP&Asm Version 2.2, then TP&Asm will not recognize
  16. it as a valid Turbo Pascal compiler.
  17.  
  18. The utility TPACFG.EXE will permit you to reconfigure your TP&Asm
  19. program file (TPA.EXE or TPA(E).EXE) to accommodate minor variations
  20. in your copy of TURBO.EXE and/or TPC.EXE.  It is designed to work with
  21. any Version 5.5 compiler, and has been tested and used to successfully
  22. reconfigure TP&Asm for the three variations of TURBO.EXE of which I am
  23. currently aware.
  24.  
  25. TP&Asm Version 2.21 will notify you if it is run with no parameters and 
  26. it does not recognize your copy of TURBO.EXE, or if is run with the "c" 
  27. shorthand syntax and it does not recognize your copy of TPC.EXE.  In
  28. that case, or if you do NOT see the following message when you run tpa 
  29. or tpa(e):
  30.  
  31.  TP&Asm  Copyright (c) 1989  Richard W. Prescott:   [Assembler is ACTIVE]
  32.  
  33. then you must use TPACFG to reconfigure the TP&Asm program file for
  34. your copy of Turbo Pascal Version 5.5.  
  35.  
  36. Version 5.0 users, if TP&Asm does not recognize your compiler, please 
  37. notify me!  I will gladly develop a configuration utility for Turbo 5.0
  38. if it should be necessary.
  39.  
  40.  
  41. 2. Usage instructions
  42.  
  43. The general syntax for using TPACFG is as follows:
  44.  
  45.                  TPACFG [Tpa22Path [Tp55Path]]
  46.  
  47. Both parameters may be omitted.  If the second parameter is omitted,
  48. the default Tp55Path is TURBO.EXE in the current directory.  If both
  49. parameters are omitted the default Tpa22Path is TPA.EXE in the current
  50. directory.
  51.  
  52.   PLEASE NOTE:  Like the TINST utility, this utility will modify the
  53.   specified TP&Asm program file without creating a backup original.
  54.   DO NOT use it on your original distribution disk!
  55.  
  56. To reconfigure your copy of TPA(E).EXE assuming that TURBO, TPC, and
  57. TPA(E) are all in the same directory, make that directory current and
  58. enter the following commands:
  59.  
  60.               TPACFG TPA(E)
  61.               TPACFG TPA(E) TPC
  62.  
  63. To reconfigure your copy of TPA(E).EXE assuming that TURBO and TPC are
  64. in one directory (say, C:\TP) and TPA(E) is in a separate directory
  65. (say, C:\TPA\22), enter the following commands:
  66.  
  67.               TPACFG C:\TPA\22\TPA(E) C:\TP\TURBO
  68.               TPACFG C:\TPA\22\TPA(E) C:\TP\TPC
  69.  
  70. To reconfigure TPA.EXE, simply use "TPA" in place of "TPA(E)" in the
  71. above statements.
  72.  
  73. If you have renamed your TP&Asm, TURBO, or TPC program files, simply
  74. substitute the new name in place of the original name listed above;
  75. TPACFG distinguishes these files based on internal characteristics
  76. rather than by name.
  77.  
  78.  
  79. 3. TPACFG output
  80.  
  81. The following series of messages indicates that TPACFG performed a
  82. successful reconfiguration of your TP&Asm program file:
  83.  
  84.   Loading compiler ...
  85.   Analyzing compiler ...
  86.   Loading TP&Asm ...
  87.   xx TPA location(s) adjusted
  88.   Saving TP&Asm ...
  89.  
  90. The following series of messages indicates that no reconfiguration
  91. was required (because TP&Asm was already configured properly for
  92. your compiler):
  93.  
  94.   Loading compiler ...
  95.   Analyzing compiler ...
  96.   Loading TP&Asm ...
  97.   0 TPA location(s) adjusted
  98.  
  99.  
  100. 4. TPACFG error messages
  101.  
  102. TPACFG will trap usage errors and respond with an appropriate error
  103. message.  Correct the specified condition and reenter the command.
  104. In case of difficulty, please check the following four conditions:
  105.  
  106.  o Tpa22Path must specify a valid TP&Asm Version 2.2 program file
  107.    which can be found by the command  DIR <Tpa22Path>[.EXE]
  108.  
  109.  o Tp55Path must specify a valid Turbo Pascal Version 5.5 compiler
  110.    file which can be found by the command  DIR <Tp55Path>[.EXE]
  111.  
  112.  o The TP&Asm program file being reconfigured must not carry the
  113.    "Read-Only", "Hidden", or "System" directory attribute.
  114.  
  115.  o The file TURBO.TPL must be available in the Turbo directory.
  116.  
  117.  
  118.  
  119. Note:
  120.  
  121. In the event that the reconfiguration should fail for a valid Version
  122. 5.5 compiler, you would see a series of messages like the following:
  123.  
  124.   Loading compiler ...
  125.   Analyzing compiler ...
  126.   ═══> Location xx Not Found
  127.   ═══> Location yy Not Found
  128.   ═══> Location zz Not Found
  129.  
  130.   Could not configure for specified compiler
  131.  
  132.  
  133. If that should happen, please (!) note the location numbers not found
  134. and notify me via CompUServe [76656,2476] or at the following address:
  135.  
  136.                     Rick Prescott
  137.                     21 Mondale Court
  138.                     Madison, WI  53705
  139.  
  140.  
  141.  
  142. TPACFG was compiled and assembled using Turbo Pascal Version 5.5 and
  143. TP&Asm Version 2.2.
  144.